LEGION Model Builder Help

Exits

Exits enable Entities to leave your model. Unless you associate the Exit with an Exit Profile, it will assume there is enough space ‘outside’ for all Entities to leave as soon as they reach the Exit.

Tip: Exits may also be used within models to represent departing trains.

An Exit Profile limits the number of people able to leave per minute. This is useful if the space outside your model acts as a potential capacity constraint. For instance, you might use an Exit Profile when you know that Entities are leaving the model to enter a narrow corridor or train carriage (see "Exit Profiles" below for more information).

An Exit can be just 20cm deep (in model scale) provided that no obstacle which an Entity might perceive (and alter its behaviour as a result) lies behind it. Otherwise, its depth needs to be 5m.

You can also associate an Availability Profile with an Exit (see "Availability Profiles" below for further information).

Setting Exit parameters

This procedure assumes the Edit Exit <name> dialog is open.

To set Exit parameters:

  1. Enter a name, or choose a name from the drop-down list of imported pending objects, in the Name box.
  2. If the Exit doesn’t require an Exit Profile, go to step 4.
  3. To associate the Exit with an Exit Profile, check the box labelled Use exit profile and select a profile from the adjacent drop-down list. For more information, see "Availability Profiles" below.
  4. If you want to link the Exit to an Availability Profile, click on the Availability tab.
  5. Select an Availability Profile from the drop-down list labelled Time Scope. If you don’t want to apply conditions, proceed to step 11.
  6. If you want to apply conditions to the Availability Profile, check the box labelled use condition.
  7. Select an option from the left-hand drop-down list:
    • AND – the condition will apply only when the Time scope settings and the conditional settings are both true.

    • OR – the condition will apply when either the Time scope settings or the conditional settings are true.

    The OR option is useful in cases where, for example, you may wish to allow a higher number of Entities out of an exit when an unforeseeable instance of high density occurs at a time not covered by the Availability Profile.

  8. Set up your condition as described from step 4 of Setting up Conditions .
  9. If you wish to apply any restrictions to the condition, click on the ‘Availability’ tab again and enter values for the following restrictions (details in Restrictions ):
    • Time before action
    • Minimum activity period
    • Maximum activity period
    • Minimum time between Actions
  10. Entities automatically navigate towards the Focal Point of the object if and when they cannot 'see' it due to obstructions. In rare instances this may cause them to move in an unexpected or illogical manner. To remedy this, click to the 'Target Parameters' tab and uncheck 'Use focal point for navigation'. In this case Entities will navigate towards the closest point on the Focal Segment.
  11. Click OK to save the parameters.

Exit Profiles

Exit Profiles work with Exits to limit (by means of a ‘Cap rate’) the flow of Entities leaving a model. An Exit Profile can be linked to several Exits and, like a Delay Profile, it can contain several intervals over time which have different Cap rates or none at all (a rate of zero will prevent any Entities from leaving).

The following procedure describes how to set up an Exit Profile that could be used with an Exit representing people entering a regulated-flow area just outside your model. This scenario could involve security controls and stadium ingress trains leaving from a platform every three minutes and taking one minute for passengers to board.

The red blocks represent periods between trains where the Exit is capped to 0, thereby preventing any Entities from Exiting (entering the ‘train’). The intervals between the blocks have no capping and therefore Entities are able to leave the Exit with no restrictions.

To create an Exit Profile:

  1. Click or select Data > Data Profiles.

    The ‘Edit Data Profile’ dialog is displayed.

  2. From the drop-down list on the left of the dialog box, select Exit Profile.
    Tip: You can also create Exit Profiles using the new Data Template spreadsheet.
  3. Click the New button in the top left-hand corner. A new ‘empty’ profile is displayed at the top of the ‘Exit Profile’ tab.
  4. Click the Add button on the right-hand side of the dialog box. A red ‘time block’ appears in the profile, spanning the whole of the simulation time.
  5. Enter a Start time of 00:01:00 and an End time of 00:04:00 in the relevant boxes.
  6. Enter a Cap rate of 0.
  7. Click Update to apply the settings for this period of the Exit Profile.
  8. Repeat steps 4 to 7 for two further time blocks, ensuring that each block’s Start time is one minute after the end of the previous block and that each block lasts for three minutes.

    Click Apply to save this profile.

    It is now available to be associated with an Exit.
    Note: To remove a time block from a profile, click on it and then click the Remove button.

    You can add as many time blocks to a profile as you can fit into the running time of your simulation, with differing Cap rates as required.

Availability Profiles

Availability Profiles enable you to turn certain spatial objects ‘on or off’ at specified times and for specified periods within the runtime of a simulation. You can create them using the Data Template spreadsheet template or you can create them manually in the following manner.

Tip: You can also create Availability Profiles using the new Data Template spreadsheet template.

To create an Availability Profile:

  1. Click or select Data > Data Profiles.

    The ‘Edit Data Profile’ dialog is displayed.

  2. From the drop-down list on the left of the dialog box, select Availability Profile.
  3. Click the New button in the top left-hand corner.

    A new ‘empty’ profile is displayed at the top of the ‘Availability Profile’ tab.

  4. Click the Add button on the right-hand side of the dialog.

    A green ‘time block’ appears in the profile, spanning the whole of the simulation time.

  5. Enter a Start time of 00:00:00 and an End time of 00:10:00 boxes. This period of 10 minutes represents the ‘ON’ period of the profile (the time when any associated object will be available for Entities to use within a simulation).

    This setting means that whichever object is associated with this profile will be available for the first ten minutes of a simulation. Of course you can tailor this period to a specific period with the runtime of your simulation.

  6. Click the Update button to apply the ‘ON’ period.

    The green time block will reflect the new period.

  7. Click OK to save the Availability Profile.